home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 34 / lanut200.zip / LANUTILS.DOC < prev    next >
Text File  |  1990-08-08  |  38KB  |  942 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.               SoftMagic LANutils Version 1.51 (12/89)
  8.               
  9.            Essential Tools for your LANtastic network.
  10.                         
  11.                All programs and documentation are
  12.    Copyright 1990,1990 by SoftMagic, Inc.  All rights reserved.
  13.                     
  14.                     
  15.                          SoftMagic, Inc.
  16.                     2801 E. Missouri, Suite 24
  17.                       Las Cruces NM,  88001
  18.                           (505) 522-5923
  19.  
  20.  
  21.                        --- INTRODUCTION ---
  22.  
  23. I'll take LANtastic over the networks that come in expensive, big
  24. red  boxes  any day. (Priced by the pound, perhaps? /jm)  It's
  25. fast , flexible, easy to  install, and easy  on  system resources.
  26. It can be a bit tricky to set up a turnkey LANtastic network for
  27. novice users, though.  Not every user  on an  office network needs
  28. or  even  wants to use  the tremendous amount  of control that
  29. LANtastic  gives over every aspect  of operation. Managing the
  30. details of  print and  mail queueing, server selection, printer
  31. selection  etc. is a frightening, unfamiliar  job for someone who
  32. just wants to run their WordStar or Lotus 123. What is needed,
  33. then is a  way  to minimize  what users  need to know about the
  34. operation  of  the network in order to get their own computer to
  35. cooperate.
  36.  
  37. At SoftMagic, we develop network software that is then sold with
  38. systems by our sister VAR, Business Networks of America. We've set
  39. up quite a few LANtastic systems and we run LANtastic in our own
  40. office.  The SoftMagic LANutils are tools that we've developed to
  41. make our job and hopefully yours too, a little bit easier. The
  42. programs in the LANutils package are: 
  43.  
  44.         LOGIN     - allows you to log in to multiple servers 
  45.                     with a single command. Adds system and
  46.                     user "login script" capability.        
  47.                     
  48.         LOGOUT    - log out of one or more servers with a single
  49.                     command.
  50.                     
  51.         WAITFOR   - pause until a given set of servers are online.
  52.         
  53.         FASTNET   - processes entire files of "NET" commands at
  54.                     once, at .
  55.         
  56.         MSET     - allows you to set variables in DOS's "master"
  57.                    environment from login script files and other
  58.                    programs run from secondary command shells.
  59.         
  60.         REBOOT   - causes your computer to reboot as though 
  61.                    Ctrl-Alt-Del had been pressed.                    
  62.                     
  63.         USERLIST  - gives you a neatly organized list of who's 
  64.                     logged in to what server.                                        
  65.  
  66.     INTERCOM   - INTERCOM is a very compact pop-up station
  67.                  to station communication program.    
  68.  
  69.     SYSTEM       - The SYSTEM utility gives your batch files
  70.              the ability to make decisions based on the
  71.              computer's hardware and software configuration.
  72.              
  73.     FU         - FindUser reports the machine names at which
  74.              a given user is logged in.
  75.                   
  76.     SU         - The SendUser utility allows you to send 
  77.                  network messages to users rather than nodes.
  78.                  
  79.     DELAY      - With DELAY, you can cause your batch files to
  80.               pause for a specified period of time.             
  81.                  
  82.     LUSETUP    - LUSETUP allows you to change the screen color
  83.                  and for MESSAGE and INTERCOM and the activation
  84.                  key for INTERCOM and Artisoft's LANPUP.
  85.                          
  86.         MESSAGE    - an improved version of MESSAGE, a pop-up,
  87.                  receive only message handler is also included.
  88.  
  89.         
  90.             --- HARDWARE AND SOFTWARE REQUIREMENTS ---
  91.  
  92. To use the LANutils, you must have a PC, AT, PS/2 or compatible
  93. computer running MS or PC-DOS 3.1 or greater and the LANtastic
  94. Network Operating System (LANOS) version 2.53 or greater.  
  95.  
  96. Special Note for 4DOS users:  
  97.  
  98. If you need to change environment variables from your login
  99. scripts, you must start 4DOS using the /M command line option to
  100. specifiy environment size instead of the normal /E. For example, 
  101.  
  102. SHELL=C:\4DOS.COM /S:B /M:512 /P
  103.  
  104. The /M option keeps 4DOS from swapping the master environment out
  105. of memory every time it loads a program.
  106.  
  107.  
  108.                 --- LICENSING AND REGISTRATION ---
  109.  
  110. We're distributing this edition of the SoftMagic LANutils as
  111. shareware. By now, you probably know that this means you get to
  112. try out the software for up to 30 days  to see if you like it.
  113.  
  114. When you decide that you like the software, you can get a
  115. registered copy of the latest version on disk, complete with a
  116. more extensive, printed manual for only $25.  The registered
  117. version, of course, runs more "quietly" -- without any shareware
  118. messages or beeps.  We always try to put a few extra "goodies" in
  119. the registered versions, too. See the file ORDER.DOC, included in
  120. LANUTILS.ZIP, for an order form when you're ready to order your
  121. copy.
  122.  
  123. You may use, copy and distribute this shareware edition of the
  124. SoftMagic LANutils FOR NONCOMMERCIAL USE ONLY if:
  125.  
  126.         No fee is charged for use, copying or distribution
  127.         
  128.         The programs and documentation are not modified in any way
  129.         
  130.         You distribute only complete, archived (LANUT153.ZIP)
  131.     copies of the LANutils package.
  132.         
  133. We offer commercial distribution licenses for both the shareware
  134. and the registered versions as well as a dealer/VAR program for
  135. authorized LANtastic dealers. Contact us at (505) 522-5923 (9am
  136. to 5:30pm MST) for details.
  137.  
  138. Of  course if you have any comments or suggestions for  additions 
  139. or  improvements  please give me (Jon Marbry) a call at the above
  140. number, or leave me a message on Artisoft's BBS or on BIX (jmarbry).
  141.  
  142. Due to the surprising number of calls we've been getting every day
  143. on this package, we can only promise technical support to registered
  144. users.  
  145.  
  146.                   *** DISCLAIMER OF WARRANTY ***
  147.  
  148. THESE PROGRAMS ARE PROVIDED ON AN AS-IS BASIS. SOFTMAGIC, INC. AND
  149. BUSINESS NETWORKS OF AMERICA MAKE NO WARRANTY, EXPRESS OR IMPLIED,
  150. AS TO PERFORMANCE, MERCHANTABILITY OR  FITNESS FOR A PARTICULAR
  151. PURPOSE. IN NO EVENT WILL SOFTMAGIC, INC. OR BUSINESS NETWORKS OF
  152. AMERICA BE HELD LIABLE FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED
  153. TO LOSS OF USE, LOST REVENUE, SPECIAL, CONSEQUENTIAL, INDIRECT OR
  154. SIMILAR DAMAGES, EVEN IF SOFTMAGIC, INC. OR AN AGENT OF SOFTMAGIC,
  155. INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO
  156. EVENT SHALL SOFTMAGIC, INC.'S LIABILITY FOR ANY DAMAGES EVER EXCEED
  157. THE PRICE PAID FOR THE SOFTWARE, REGARDLESS OF THE FORM OF THE 
  158. CLAIM.  
  159.        
  160.                         --- SHAREWARE ---
  161.                         
  162. Got a minute to listen to a lecture? Good! I'll try and keep it
  163. brief.  IT IS VITALLY IMPORTANT TO THE FUTURE OF THE SOFTWARE
  164. INDUSTRY THAT YOU SUPPORT SHAREWARE DISTRIBUTION. There are many
  165. reasons, here are a few that come immediately to mind:
  166.  
  167. Reason 1: It costs too much to distribute products through the 
  168.           normal channels for products with a specialized
  169.           audience to ever break in.
  170.  
  171.           A friend of mine who is an account rep for a major
  172.           distributor told me last month that "you can't launch a
  173.           new program for less than a quarter million anymore."
  174.           That's just packaging and advertising! You've got
  175.           to convince the public and your dealers that they 
  176.           can't live without your product so that you can sell
  177.           those thousands of units a month needed to break even.
  178.           
  179.           Shareware does two wonderful things that make spending
  180.           all that money unneccessary.  It provides a very
  181.           inexpensive mechanism for international distribution --
  182.           the public bulletin board -- so that millions of users
  183.           have access to new software, and it allows the user
  184.           to thoroughly test the software before buying it.  
  185.           
  186. Reason 2: Computer resellers can't afford to stock new, unknown
  187.           software products for specialized markets.
  188.           
  189.           I know, I've been there. When margins are as tight
  190.           as they are now, you've got to keep that inventory
  191.           moving. Even with a good stock balancing plan, it's 
  192.           hard to bring yourself to risk limited inventory funds
  193.           and shelf space on a new product when you KNOW you 
  194.           can sell 10 more copies of WordPerfect. 
  195.           
  196.           Shareware gives you, the user, the opportunity to
  197.           evaluate (and possibly purchase) quality software that
  198.           you might never see at a computer store.
  199.           
  200. Reason 3: Shareware distribution rewards small companies that
  201.           are spending their time and money creating new and
  202.           useful products. That's important! Some this 
  203.           industry's biggest, best equipped companies are
  204.           now opting to use litigation instead of innovation
  205.           to protect their products and markets.
  206.           
  207.           Back in ECON 351, I learned that this trend is typical
  208.           of maturing industries in which economic profits are
  209.           being squeezed out. Litigation forces companies without
  210.           BIG capital reserves out of the industry and raises
  211.           barriers to entry. 
  212.           
  213.           The software industry is still young enough that your
  214.           actions as a user and purchaser can make a difference in
  215.           the attitude of the software industry. Purchasing
  216.           quality shareware products is a great way to "vote with
  217.           your pocketbook" against the legal squabbling that is
  218.           threatening creative freedom and diversity in PC
  219.           software.
  220.           
  221. Whew! Enough said.  Now I'll get down from my soapbox and give you
  222. the details about each program in the LANutils package.  
  223.  
  224.  
  225.                          --- LOGIN ---
  226.  
  227. The LOGIN utility allows you to log onto multiple servers with  a 
  228. single command.  LOGIN is really handy for setting up boot disks 
  229. on floppy-only workstations, since you don't have the overhead of 
  230. loading NET over and over for each login. 
  231.  
  232. In addition, LOGIN provides a "login script" both for servers and 
  233. for  individual  users.  LOGIN  will  automatically  redirect   a 
  234. specified  drive to the server's network directory and execute  a 
  235. batch file keyed to the user's name.   
  236. The syntax for LOGIN is:
  237.  
  238. LOGIN <server list> <user id list> <password list> [/OPTIONS]
  239.  
  240. The  server  list is a list of file servers to  be  logged  into, 
  241. separated by commas.  The list is processed sequentially, left to 
  242. right.  An  asterisk  (*)  in the server  list  field  means  all 
  243. currently available (but not logged in) servers.
  244.  
  245. The  user id list is a list of user ids, one to a server.   Again 
  246. the  list  is scanned from left to right.  If  more  servers  are 
  247. specified  that  ids, the id list will be reused  in  a  circular 
  248. fashion.   This  makes  it easy for you to  log  in  to  multiple 
  249. servers under the same user id.
  250.  
  251. The  password list works the same way as the user id list.  If  a 
  252. question mark (?) is entered as the password for a server,  LOGIN 
  253. will  prompt the user for the password at an  appropriate  point. 
  254. The  password  list  will also be recycled if  more  servers  and 
  255. userids  are  specified than passwords.  If you've got  the  same 
  256. user ID and password on all the servers on your net, you can  log 
  257. in everywhere with the command.
  258.  
  259. LOGIN * USERNAME ?
  260.  
  261. LOGIN  will ask you once for your password, then it will log  you 
  262. on to all the available servers on the net.
  263.  
  264. If  you  omit  any  of the  parameters,  LOGIN  will  prompt  you 
  265. accordingly. For example, the command
  266.  
  267. LOGIN
  268.  
  269. results  in the following exchange: (Text in all caps entered  by 
  270. user)
  271.  
  272. Server: SERVER1,SERVER2
  273. Userid: MANAGER
  274. Password: PASS  (Not really a good idea for a password, of course!)
  275.  
  276.  
  277.                       COMMAND LINE OPTIONS
  278.  
  279. /NODUPLICATES
  280.  
  281. LOGIN's default behavior on encountering a duplicate login  error 
  282. is to log the user out of that server and retry the login without 
  283. saying anything to the user.
  284.  
  285. If  the /NODUPLICATES option is specified, attempts to log in  to 
  286. the same server more than once will be reported as errors.
  287.  
  288. /NOSCRIPT
  289.  
  290. The /NOSCRIPT option allows you to log in without invoking either 
  291. the system or user login script facilities.  This option is  only 
  292. necessary  when the specified servers HAVE login scripts and  you 
  293. want to bypass them.  LOGIN is smart enough not to try to execute 
  294. login scripts on servers that don't have them set up.
  295.  
  296. /SUPPRESS
  297.  
  298. The  /SUPPRESS option prevents LOGIN from displaying ANY  warning 
  299. or  error messages.  If an error does occur however,  LOGIN  will 
  300. still terminate with a non-zero return code, so your batch  files 
  301. can detect any problems.
  302.  
  303. /HELP
  304.  
  305. /HELP displays a brief instruction summary and a list of  command 
  306. line options. If the /HELP option is specified, all other command 
  307. line input is ignored and no action (i.e. logging in) is taken.
  308.  
  309.  
  310.                     THE LOGIN SCRIPT FACILITY
  311.  
  312. A  login script is simply a batch file to be executed whenever  a 
  313. user logs in to a server.  LOGIN supports two types of scripts, a 
  314. system  login  script,  executed by everyone who  logs  into  the 
  315. server,  and  a user specific login script, with commands  to  be 
  316. executed only when a particular user logs in. 
  317.  
  318. With  the login script capability, when a user logs in,  you  can 
  319. set   his  PROMPT,  COMSPEC  and  other  environment   variables, 
  320. automatically configure a set of network devices for him, print a 
  321. welcoming message, display news bulletins, or even log him  right 
  322. back out.
  323.  
  324. LOGIN  expects  all  its login script files to  be  kept  in  the 
  325. server's  network directory, LANTASTI.NET (the \. device  in  the 
  326. NET  menu).  To create a system login script for a  server,  just 
  327. put  the  commands  you  want executed in  a  batch  file  called 
  328. $SYSTEM.BAT  in  the  network directory.  Similarly,  user  login 
  329. scripts are just batch files with the same names as their  users.  
  330. For example user BOB 's login script would be called BOB.BAT.  
  331.  
  332. Login scripts can contain any command that you'd normally use  in 
  333. a batch file. The node name of the user's machine (the name given 
  334. in the REDIR command) is given to both the system and user script 
  335. files as the first parameter, %1, so that you can check it and do 
  336. different things for different stations (like changing COMSPEC on 
  337. floppy based stations to use a faster network disk). A couple  of 
  338. warnings, however: If you use external (disk based) commands,  be 
  339. sure that the user's computer has a path to them. It's easiest to 
  340. do  all your redirections first, set up proper paths,  then  call 
  341. external  commands. 
  342.  
  343. To set environment variables from login scripts you must use the
  344. included MSET utility. MSET works the same way as the DOS SET
  345. command, but it modifies the master copy of the environment, no
  346. matter how many levels deep in shells and menus you may be. For
  347. example, to set the path in a login script, use the command
  348.  
  349. MSET PATH=F:\;F:\UTILITY;F:\LANTASTI
  350.  
  351. A  Brief  Technical  Note:  The login script  facility  works  by
  352. temporarily  redirecting  drive B: on the user's station  to  the
  353. server's  network directory. The redirection is always  cancelled
  354. after the login script is done. I chose B: because most  machines
  355. don't  need to use the B: floppy (even if they really  have  one)
  356. during  bootup.   If  you normally redirect the  B:  drive  to  a
  357. network  drive however, you will have to wait until  after  LOGIN
  358. has executed to redirect it.
  359.  
  360.           
  361.                         --- LOGOUT ---          
  362.                         
  363. LOGOUT allows you to log out of one or more servers with a single 
  364. command. Its syntax is
  365.  
  366.         LOGOUT <server list> [/HELP]
  367.  
  368. The server list is a list of servers separated by commas,  spaces 
  369. or plus signs.  An asterisk '*' is used to specify all  currently 
  370. active servers, so the command
  371.  
  372.         LOGOUT *
  373.                 
  374. will log you out of all the servers that you are currently logged 
  375. into, as will simply entering the LOGOUT command with no arguments.
  376.  
  377. The  only available command line option is the /HELP option.   As 
  378. with  LOGIN, /HELP causes a brief instruction summary and a  list 
  379. of  available  options to be displayed. If  /HELP  is  specified, 
  380. LOGOUT  will take no other action -- it will not log you  out  of 
  381. any servers.
  382.  
  383.  
  384.                         --- WAITFOR ---
  385.                         
  386. OK, this is the situation -- you've set up a small office, with 6 
  387. or  7 computers connected by LANtastic.  They're turned off  each 
  388. night  after work and turned on in the morning.  It's  a  totally 
  389. turnkey system, so the network is started and everyone is  logged 
  390. in automatically.  So far so good.        
  391.                 
  392. Now  here's the problem.  There's no way you can turn 6 or 7  (or 
  393. 10 or 12) computers on at exactly the same time.  Unless you  put 
  394. a
  395.  
  396.         PAUSE "Press any key when all the machines are ready..."
  397.  
  398. statement in the AUTOEXEC file, the automatic logins stand a good 
  399. chance of failing because of missed timing.
  400.  
  401. The solution? 
  402.  
  403.         WAITFOR <list of servers> [/OPTIONS]
  404.         
  405. WAITFOR will cause the computer to pause until all the servers in 
  406. the given list are on line, or until the escape key is pressed or 
  407. optionally until a specified time-out interval is exceeded.        
  408.         
  409.          
  410.                       COMMAND LINE OPTIONS
  411.  
  412. /TIME=[1..999 seconds] (default: no timeout)
  413.  
  414. The  /TIME  option lets you set the maximum length of  time  that  
  415. WAITFOR will sit around and wait for all the specified servers to 
  416. come on line.  If /TIME is not set, WAITFOR will wait forever.
  417.  
  418. /HELP
  419.  
  420. /HELP displays a brief instruction summary and a list of  command 
  421. line options. If the /HELP option is specified, all other command 
  422. line input is ignored and no other action is taken.
  423.  
  424.  
  425.                          --- FASTNET ---
  426.  
  427. Sometimes it seems to take forever for a batch file of "NET  USE" 
  428. commands  to  execute, especially on floppy  based  workstations.  
  429. The  poor computer not only has to execute the commands, it  also 
  430. has  to  reload  the 16K NET utility for  each  command.  FASTNET 
  431. speeds  things  up  by  processing a whole  file  full  of  "NET" 
  432. commands  at  once.  You can use the batch interpreter  to  debug 
  433. your  network setup, then when you're done, just use the name  of 
  434. your batch file as a parameter to FASTNET and see how much faster 
  435. it runs.
  436.  
  437. FASTNET handles the following NET commands, exactly as  described 
  438. in your LANtastic documentation:
  439.  
  440. NET USE D: \\Server_name
  441. NET USE D: \\Server_name\Path\...\Path
  442. NET USE LPTn: \\Server_name\@Device                
  443. NET UNUSE D:
  444. NET CLOCK \\Server_name
  445. NET LPT [COMBINE,FLUSH,SEPARATE]
  446. NET LPT TIMEOUT t                           
  447. NET QUEUE [START,STOP,HALT,PAUSE,SINGLE,RESTART] \\Server_name
  448.  
  449. If  FASTNET doesn't directly support a command (such as NET  SHOW 
  450. or NET POSTBOX or other batch commands) it will pass it on to the 
  451. command  processor.   In  this way, FASTNET can  handle  all  NET 
  452. commands  and  all  batch file commands  except  those  involving 
  453. branching  within  the  batch file  and  changes  to  environment 
  454. variables.  If  an error occurs, FASTNET returns the  same  error 
  455. messages that NET does, and returns with a non zero error code.
  456.  
  457. FASTNET's syntax is:
  458.  
  459.         FASTNET <file name> [/OPTIONS]                         
  460.         
  461. The filename can be any valid DOS file name. If no extension is
  462. given, an extension of .BAT is assumed.        
  463.                          
  464.  
  465.                       COMMAND LINE OPTIONS
  466. /STOP
  467.  
  468. Normally, if an error occurs, FASTNET will report it and continue  
  469. processing.   If you use the /STOP option, however, FASTNET  will 
  470. immediately terminate with an appropriate return code if any kind 
  471. of error occurs.  
  472.  
  473. /SUPPRESS
  474.  
  475. The /SUPPRESS option prevents FASTNET from displaying ANY warning 
  476. or error messages.  If an error does occur however, FASTNET  will 
  477. still terminate with a non-zero return code, so your batch  files 
  478. can detect any problems.
  479.  
  480. /HELP
  481.  
  482. /HELP displays a brief instruction summary and a list of  command 
  483. line options. If the /HELP option is specified, all other command 
  484. line input is ignored and no other action is taken.
  485.  
  486.  
  487.                         --- MESSAGE ---
  488.                         
  489. The MESSAGE utility is an alternative to LANtastic's built in pop
  490. up message receiver.  Like the built in message handler, MESSAGE
  491. causes messages sent to your machine  with  "NET  SEND" to pop up
  492. on the bottom  lines  of  your screen. Unlike the built in
  493. handler, messages thus popped up will stay on your screen until
  494. you tell them, via the escape key, to leave.  The message display
  495. also includes information on who sent you the message and the time
  496. at which it was sent for your reference.  If you're away from your
  497. desk a lot, MESSAGE will probably work better for you than
  498. LANtastic's message handler, since your messages won't vanish
  499. after a certain interval, never to be seen again. 
  500.  
  501. MESSAGE will also pop up even over graphics programs (by popular
  502. demand). Be warned however, that to save memory, it doesn't save
  503. the underlying screen. You get your message, but you must ask your
  504. application to redraw the screen. Also, as is the case with quite
  505. a few resident programs, MESSAGE doesn't always behave well with
  506. Windows 3.0. 
  507.  
  508. To install the MESSAGE utility, enter the command
  509.  
  510.         MESSAGE
  511.  
  512. The computer will display the installation message 
  513.  
  514.  
  515. SoftMagic Resident Message Handler Version 1.5 for LANtastic
  516.   Copyright 1990 by SoftMagic, Inc.  All rights reserved.
  517.         LANtastic is a trademark of Artisoft, Inc.
  518.  
  519. MESSAGE has no parameters or command line  options and it's 
  520. smart enough not to let you install more than one copy at
  521. a time. Note that if you chose to use MESSAGE, you can disable
  522. Artisoft's pop-up function by entering the command
  523.  
  524.     NET MESSAGE/DISABLE POP
  525.  
  526. at the DOS prompt or in a batch file.
  527.  
  528.  
  529.                           --- REBOOT ---
  530.                           
  531. REBOOT is a small program that causes your computer to execute                          
  532. a "hard" reboot -- a restart that clears everything out of memory
  533. and runs your computer's power-on diagnostics.  
  534.  
  535. It can be handy for all sorts of things, from providing a foolproof
  536. way of resetting communications hardware from a batch file to 
  537. keeping people out of places where they don't belong. I've even
  538. got the habit of typing REBOOT instead of Ctrl-Alt-Del whenever
  539. I need to reboot my machine.  
  540.  
  541. To use REBOOT, simply enter 
  542.  
  543. REBOOT
  544.  
  545. at the DOS command line or in a batch file.  There are no options
  546. or command line parameters. You wanna reboot, you gotta reboot!
  547.  
  548.  
  549.                            --- MSET ---
  550.  
  551. The MSET utility allows you to set or change variables in the
  552. "master copy" of the environment -- the one that belongs to the
  553. command processor that was loaded when your computer was first
  554. started.  You use MSET exactly the same way you would use the
  555. SET command:
  556.  
  557.         MSET <variablename>=<value>
  558.         
  559. For example, to set the variable MONITOR to CGA, you would issue
  560. the command 
  561.         
  562.         MSET MONITOR=CGA
  563.         
  564. MSET is provided with the LANutils specifically so that you can 
  565. set master environment variables from login scripts run by the
  566. LOGIN command.  Just substitute MSET for SET in all your login
  567. scripts and the "right" copy of the environment will be altered.
  568.  
  569.                          --- USERLIST ---
  570.                          
  571. I wrote this one after working on a network in a large office -- I
  572. wanted to send someone a message but I didn't know where they were
  573. logged on. So off I went, through the NET menus, checking the
  574. "Display System Activity on Server" screen for all the various
  575. servers that I was logged into.  "There must be an easier way", I
  576. thought.                             
  577.  
  578. USERLIST makes it easy to find people on the network.  It tells
  579. you who's using what machine and who's logged into which servers.
  580. For example, the userlist for our office network as I write looks
  581. like this:
  582.  
  583.         Users on server JON:
  584.           JON on machine JEARL
  585.           JON on machine JON
  586.           CAROLYN on machine CAROLYN
  587.         (3 users)
  588.  
  589.         Users on server CAROLYN:
  590.           CAROLYN on machine CAROLYN
  591.           JON on machine JEARL
  592.           JON on machine JON
  593.         (3 users)
  594.  
  595.         Users on server JEARL:
  596.           JON on machine JEARL
  597.           JON on machine JON
  598.         (2 users)
  599.  
  600. As you can see, there are a few of us still here at midnight.
  601. To get a user list, type
  602.  
  603.         USERLIST <server list> [/HELP]
  604.  
  605. The  only available command line option is the /HELP option.   As
  606. with the rest of the LANutils, /HELP causes a brief instruction
  607. summary and a  list of  available  options to be displayed. If
  608. /HELP  is  specified, USERLIST will take no other action.
  609.  
  610.  
  611.                            --- INTERCOM ---
  612.                            
  613. At only 2.9K, INTERCOM is the smallest two way pop-up communicator
  614. I've come across.  It allows you to pop up a window from virtually
  615. any application, carry on a conversation with one or several other
  616. users, then return immediately to your application.  
  617.  
  618. To load INTERCOM, type
  619.  
  620.     INTERCOM
  621.     
  622. at the DOS prompt (or include it in your AUTOEXEC.BAT file). Once
  623. the program is loaded, to pop up the INTERCOM window, press Alt-I .
  624. (If you need to, you can change the activation key with the
  625. supplied LUSETUP program).  The INTERCOM window looks like this:
  626.  
  627.      +-From: USERNAME ---------------------------------------------+  
  628.      | This is the (incoming) message line.                        |
  629.      +-To:---------------------------------------------------------+
  630.      | USERNAME                                                    |
  631.      +===========================================Press Esc to exit=+  
  632.  
  633. It's really a lot easier to just try out intercom a time or two
  634. than it is to try to explain how to use it. The top line of the
  635. window tells who last sent you a message and the second line
  636. displays the text of the last received message. The third line
  637. holds a prompt that tells you what to type in the fourth line.
  638.  
  639.     If the prompt is "To:: (as in the example above), enter
  640.     the node name of the station to which you're sending.
  641.     
  642.     If the prompt is "Message:", enter the text of your
  643.     message. You can enter up to 65 characters of text.
  644.     
  645. To move between "To:" and "Message:" fields, use the up and down
  646. arrow keys or simply press enter. Once you have filled out both
  647. fields, press enter and your message will be sent.  For example,
  648. to send a message to node MANAGER, you would use the following
  649. commands:
  650.     Alt-I         (to pop up the INTERCOM window)
  651.     MANAGER       (the name of the intended recipient)
  652.     <enter>       (to switch to the "Message:" field)
  653.     HI THERE      (the text of the message)
  654.     <enter>       (to transmit the completed message)
  655.     
  656. At this point, a message has been transmitted and you can either wait
  657. for a reply or press the escape key to return to what you were doing
  658. before you activated INTERCOM.
  659.  
  660. Note that although you can pop up INTERCOM over graphics programs,
  661. when you leave INTERCOM by pressing escape, it does not restore
  662. the graphics screen. This is a result of a compromise made in the
  663. interest of keeping INTERCOM's RAM usage as low as possible. With
  664. most graphics programs, this isn't much of a problem because the
  665. application itself provides an easy way to redraw the screen. For
  666. other applications, it's easiest to handle it the way I do MS
  667. WINDOWS -- I use MARK and RELEASE to unload INTERCOM before
  668. starting.
  669.  
  670.                           --- SYSTEM ---
  671.  
  672. Have you ever accidentally run a copy of 123 on a network station
  673. with the "wrong" type of video hardware?  The same diversity of
  674. hardware options that makes the PC such a useful computer can 
  675. cause all kinds of headaches for network administrators.
  676.  
  677. Typically, efforts to avoid the problem of different, incompatible
  678. hardware on the network turn even the fanciest, most expensive
  679. system into a jungle of batch files.  For example, to solve the
  680. problem above, you must either write a special batch file for each
  681. type of video hardware or teach all your users to start 123 with
  682. the correct driver set, or both.  In any case, you're likely to
  683. wind up with some confused users with blank, black screens. What
  684. a headache!
  685.  
  686. That's where SYSTEM comes in.  SYSTEM lets your batch files ask
  687. the computer about its hardware and software configuration so 
  688. you can easily pick exactly the right program version or driver
  689. set.  To demonstrate, here's a batch file that solves the 123
  690. video driver problem:
  691.  
  692.     ECHO OFF
  693.     REM Batch file to run Lotus 123 with the proper driver set
  694.     REM for the computer's video board.  Note that the driver
  695.     REM sets must have been created in advance using the Lotus
  696.     REM INSTALL program.
  697.  
  698.     REM Check for monochrome or Hercules video
  699.     SYSTEM (VIDEO LT CGA)
  700.     IF ERRORLEVEL 1 GOTO COLOR
  701.     123 MONO
  702.     GOTO END
  703.  
  704.     :COLOR
  705.     REM Check for CGA video
  706.     SYSTEM (VIDEO = CGA)
  707.     IF ERRORLEVEL 1 GOTO EGA
  708.     123 CGA
  709.     GOTO END
  710.  
  711.     :EGA
  712.     REM Check for EGA 
  713.     SYSTEM (VIDEO = EGA)
  714.     IF ERRORLEVEL 1 GOTO VGA
  715.     123 EGA
  716.     GOTO END
  717.  
  718.     :VGA
  719.     SYSTEM (VIDEO = VGA)
  720.     IF (ERRORLEVEL 1) GOTO ERROR
  721.     123 VGA
  722.     GOTO END
  723.  
  724.     :ERROR
  725.     ECHO Error: Unable to determine video adapter type 
  726.  
  727.     :END
  728.  
  729. Think of SYSTEM as an extension to DOS's "IF" command.   You ask
  730. SYSTEM a question with a true/false answer and it places the
  731. result in the DOS ERRORLEVEL variable -- 0 if the answer was true,
  732. 1 if it was false. You can then use "IF ERRORLEVEL" to check the
  733. result.  The batch file above uses this strategy to accomplish two
  734. things: it runs 123 with the correct driver set for each video
  735. board and it detects errors and gives a safe exit route if the
  736. video board type is unknown.
  737.  
  738.  
  739. The formal syntax for SYSTEM is:
  740.  
  741. SYSTEM <expression> | <@filename> [/OPTIONS]
  742.  
  743. An <expression> is a question composed of a system parameter, a
  744. relational operator and a value. For example, the expression
  745.  
  746.     (EXPANDED = 512)
  747.  
  748. in effect asks the question, "Does this computer have exactly 512K
  749. of expanded memory available?" Expressions can be more complex, as
  750. in
  751.  
  752. (EXPANDED GE 512) AND (VIDEO GE EGA) AND (MOUSE = YES)
  753.  
  754. which asks the compound question, "Does this computer have at
  755. least 512K of expanded memory, EGA video or better and a mouse?"
  756. For all you compiler-writing hacker types out there, SYSTEM scans
  757. expressions from right to left and evaluates from left to right,
  758. using no operator precedence. SYSTEM recognizes the following
  759. system parameters:
  760.  
  761. CPU        - the computer's CPU type, 8086/88, 80286 or 80386
  762. FPU        - is the computer equipped with a coprocessor? YES or NO
  763. MEMORY       - the amount of available conventional memory
  764. EXPANDED   - the amount of available expanded memory
  765. EXTENDED   - the amount of installed extended memory
  766. DISK       - the amount of disk space available on the current drive
  767. VIDEO       - the type of video adapter installed on the computer
  768.          MONO, HERCULES, CGA, EGA or VGA
  769. MOUSE      - is an MS compatible mouse driver loaded? YES or NO
  770. DOSVER     - the current MS-DOS version number
  771. LANVER     - the current LANtastic version number
  772.  
  773. Relational operators available are:
  774.  
  775. Operator(s)         Meaning
  776. --------------------------------------------
  777. =,==,EQ             Equality:                  
  778. !=,NE               Inequality:                
  779. GT                  Greater than:              
  780. LT                  Less than:                 
  781. GE                  Greater than or equal to   
  782. LE                  Less than or equal to      
  783. AND,&,&&            AND                        
  784. OR,|,||             OR                         
  785.  
  786. Here's a complex SYSTEM expression that asks if a station is
  787. capable of running large Microsoft Windows programs like Excel and
  788. Word for Windows.
  789.  
  790. (CPU GT 8088) AND (MEMORY GT 450) AND (EXP GT 512) AND (VIDEO GE EGA)
  791.  
  792. A batch file using the expression to run Excel would look something
  793. like this:
  794.  
  795.     ECHO OFF
  796.     REM This batch file runs MS Excel on stations equipped with 
  797.     REM at least an 80286 CPU, at least 450K of free conventional 
  798.     REM memory, at least 512K of EMS memory, and at least EGA
  799.     REM video.
  800.  
  801.     SYSTEM (CPU GT 8088) AND (MEMORY GE 450) AND (EXP GE 512) 
  802.             AND (VIDEO GE EGA)
  803.     IF ERRORLEVEL 1 GOTO ERROR
  804.     EXCEL
  805.     GOTO END
  806.  
  807.     :ERROR      
  808.     ECHO This station is not equipped to run Excel.
  809.     
  810.     :END
  811.  
  812.  
  813. SYSTEM has two command line options that you can use to get extra
  814. information. They are:
  815.  
  816.                               /HELP
  817. The HELP option    displays a brief instruction summary for the SYSTEM
  818. program. You can also get the HELP instructions by typing 
  819. SYSTEM
  820. on the command line with no parameters.
  821.  
  822.                              /REPORT
  823. Use the REPORT option if you'd like to see exactly what hardware
  824. and operating software your computer is equipped with. You'll get
  825. a summary report that looks like this:
  826.  
  827. SYSTEM utility for LANtastic -- Copyright 1990 by SoftMagic, Inc.
  828. All rights reserved.  LANtastic is a trademark of Artisoft, Inc.
  829.  
  830. Current system configuration:
  831. -----------------------------------
  832. Hardware
  833.   CPU: 80286
  834.   FPU: INSTALLED
  835.   Video: EGA
  836.   Mouse: INSTALLED
  837. -----------------------------------
  838. Available Memory
  839.   Conventional: 349K
  840.   Expanded:     880K
  841.   Extended:     0K
  842. -----------------------------------  
  843. Disk space available: 442K
  844. -----------------------------------
  845. Software
  846.   DOS Version:       3.30
  847.   LANtastic Version: 2.57
  848. -----------------------------------  
  849.           
  850.                             --- FU ---
  851.  
  852. The Finduser utility, FU for short, is a quick way to find out where
  853. people are logged on. It's syntax is:
  854.  
  855. FU <user name 1,user name 2,...user name n> [/OPTIONS]
  856.  
  857. User names can be separated by commas or spaces.  The only
  858. available option is /HELP, which displays the condensed version of
  859. these instructions. To give you an idea of what FU does, I'm going
  860. to find out where user Mark is currently logged in.
  861.  
  862.     FU MARK
  863.     MARK is logged in to server \\CAROLYN using machine MARK.
  864.     MARK is logged in to server \\MAIN using machine MARK.
  865.  
  866.                             --- SU ---
  867.                             
  868. Senduser, SU for short, lets you route network messages to
  869. specific users rather than to nodes. For example, to send a
  870. message to user MARK, no matter what machine he is currently
  871. using, just type
  872.  
  873.     SU MARK "Hello there, Mark"
  874.     
  875. SU will automatically determine where Mark is logged in, and
  876. get the message to him. 
  877.  
  878. Note that you can send messages to more than one user. For example,
  879. to send a message to MARK, JON and CAROLYN, type
  880.  
  881.     SU MARK,JON,CAROLYN "Hello ladies and gentlemen!"
  882.  
  883.                           --- DELAY ---
  884.  
  885. If you're running your network software from your computer's
  886. AUTOEXEC.BAT file, you may have noticed that some servers on the
  887. net may not respond to your first attempt to log on. In fact,
  888. sometimes you may not even be able to log on the first time to a
  889. server that's running on the computer you're using.
  890.  
  891. Usually this is due to the fact that LANtastic servers broadcast
  892. their existance on the net only every few seconds. If your
  893. computer comes up between ID broadcasts, it will not see a given
  894. server until the next time its ID is broadcast.
  895.  
  896. The WAITFOR utility gets around this problem by simply waiting
  897. until all the specified servers are available -- but what if you
  898. don't know in advance which servers are going to be available?
  899.  
  900. DELAY provides an easy answer. Its formal syntax is:
  901.  
  902. DELAY <time> [<message>] [/HELP]
  903.  
  904. You can specify any delay time from 0 to 32768 seconds. The optional
  905. <message> will be displayed on the screen before the delay begins.
  906. The /HELP argument displays a brief summary of DELAY's instructions
  907. on the screen. Pressing the Escape key during a delay will cause
  908. the delay to be aborted, returning you to normal operation.  If you
  909. want to stop a delay and return to the command line, press Ctrl-C.
  910.  
  911. To give LANtastic time to listen for server IDs, just insert a few
  912. seconds of delay between the time you start your network software
  913. and the time you try to log in. For example, if you include the
  914. sequence 
  915.  
  916.     LANBIOS2
  917.     REDIR
  918.     SERVER
  919.     DELAY 5 Pausing to see who's out there...
  920.     LOGIN ?
  921.     
  922. in your AUTOEXEC.BAT file, your computer will pause for 5 seconds
  923. after running the LANtastic server and before attempting to log
  924. in. This should be plenty of time for all the servers on the net
  925. to identify themselves.    
  926.  
  927.                          --- LUSETUP ---
  928.                          
  929. LUSETUP allows you to change the screen colors for the pop-up
  930. programs MESSAGE and INTERCOM and the activation keys for INTERCOM
  931. and Artisoft's LANPUP. For LUSETUP to work, you have to be in the
  932. directory that contains MESSAGE.COM and INTERCOM.COM.
  933.  
  934. To start LUSETUP, type
  935.  
  936.     LUSETUP
  937.     
  938. from the DOS command line. LUSETUP is menu driven and is fairly
  939. self explanitory. Complete instructions for changing colors and
  940. hotkeys are displayed on the screen. 
  941.  
  942.